home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 26 / Cream of the Crop 26.iso / utility / dirco707.zip / BRUCE.DOC next >
Text File  |  1997-07-31  |  15KB  |  273 lines
  1. BRUCE.DOC                              1                           Jul 31, 1997
  2.  
  3. -------------------------------------------------------------------------------
  4.                                   Introduction
  5.  
  6. This documentation provides some overview information on a number of utilities.
  7. All programs  described  herein  were  written  by  Bruce  Guthrie.   Most  are
  8. distributed with a Wayne Software copyright.  Others were written for the  U.S.
  9. Department of Commerce.
  10.  
  11. All programs are free for use provided relevant documentation is kept with  the
  12. programs, no changes are made to the programs or documentation,  and  they  are
  13. not bundled with commercial programs or charged for separately.
  14.  
  15. CHANGE, CONVERT, READ, and READY are  excluded  from  the  commercial-packaging
  16. restriction.  These programs are owned by the U.S. Department of  Commerce  and
  17. may be re-distributed without restriction.
  18.  
  19. People who need to  bundle  AV,  BFIND,  COPSINCE,  DATES,  DIRCOMP,  DIRTOTAL,
  20. EUMAIL, FILL, FILUPDAT, FIXTEXT, FORTUNE, HTMSTRIP, MOZ, PAGINATE, READINIT, or
  21. TXTABLE in commercial packages other than shareware/freeware  collections  must
  22. pay a $50 registration fee  to  "Wayne  Software"  at  the  following  address.
  23. READMAKE-created files are also subject to this limitation.  I don't expect  to
  24. make any money from these utilities but  I  don't  want  others  to  sell  them
  25. instead.  Shareware-distribution groups that charge more than $7 for a diskette
  26. or $20 for a CD-ROM are, as far as I'm concerned, making excessive profits from
  27. these programs--their actual costs are way  below  this--and  probably  keeping
  28. people from registering the other shareware on the disk; I do  not  want  these
  29. types of places distributing my programs.
  30.  
  31. This collection of utilities were compiled using Microsoft's Visual  BASIC  for
  32. DOS 1.0 compiler in addition  to  Thomas  G.  Hanlin  III's  excellent  PBClone
  33. routines.  Since DOS compilers and libraries  are  not  being  maintained  much
  34. anymore, adding new data formats and such may not be possible.  Since they  are
  35. DOS-based, forget long Win95 and WinNT file names and such.
  36.  
  37. Documentation provided in appropriate ZIP files:
  38.  routine.DOC:   Each utility is separately  described  in  a  like-named  *.DOC
  39.                 file.
  40.  FILE_ID.DIZ:   Standard "Description In Zip" file.
  41.  BRUCE.DOC:     This file serves to summarize all of the various utilities.
  42.  BRUCEINI.DOC:  Most of the routines have defaults that can  altered  by  using
  43.                 initialization files (inifiles).  These are referenced  in  the
  44.                 regular documentation and further described here.
  45.  BRUCEHEX.DOC:  Many of the routines allow you to enter  parameters  as  either
  46.                 hexadecimal or decimal strings.   This  is  referenced  in  the
  47.                 regular documentation and further described here.
  48.  HISTORY.ymm:   List of  recent  modifications  to  all  programs.   The  "ymm"
  49.                 indicates the release date in year/month format.   "601"  means
  50.                 1996, first month (Jan 1996).
  51.  
  52. All program documentation was created using a text editor (PE2).  The  PAGINATE
  53. command (see below) was used to  justify  the  text  and  create  titles,  page
  54. breaks, and (where provided) indexes.
  55.  
  56.  
  57. BRUCE.DOC                              2                           Jul 31, 1997
  58.  
  59. -------------------------------------------------------------------------------
  60.                               Contact information
  61.  
  62. For the following routines:  AV, BFIND,  COPSINCE,  DATES,  DIRCOMP,  DIRTOTAL,
  63. EUMAIL,  FILL,   FIXTEXT,   FORTUNE,   HTMSTRIP,   MOZ,   PAGINATE,   READINIT,
  64. READMAKE-created files, and TXTABLE:
  65.  
  66.                 Bruce Guthrie
  67.                 Wayne Software
  68.                 113 Sheffield St.
  69.                 Silver Spring, MD 20910
  70.  
  71.                 e-mail: WayneSof@erols.com   fax: (301) 588-8986
  72.                 http://www.geocities.com/SiliconValley/Lakes/2414
  73.  
  74. For the following routines:  CHANGE, CONVERT, FILUPDAT, READ, and READY:
  75.  
  76.                 Bruce Guthrie
  77.                 Room H-4885
  78.                 U.S. Dept of Commerce/ESA/STAT-USA
  79.                 Washington, DC 20230
  80.  
  81.                 fax: (202) 482-2164
  82.                 voice: (202) 482-3234
  83.                 e-mail: bguthrie@doc.gov
  84.  
  85. Please provide an Internet e-mail address on all correspondence.
  86.  
  87. Since these programs are typically "freeware" (with  the  exception  of  people
  88. trying to make money from them instead of me), they generate maybe $100/year in
  89. revenue for me.  As such, my ability to afford wonderful  customer  support  is
  90. somewhat restricted.  Please  do  not  leave  messages  saying  "Call  me  long
  91. distance".  Also, please be specific about  what  problems  you  encounter  and
  92. include command-line inputs as well as any control or  INI  files  that  you're
  93. using.
  94.  
  95. Beta testers and suggestions are always appreciated.  Among other things,  beta
  96. testers receive e-mail  notification  whenever  major  enhancements  are  made.
  97. Contact me at WayneSof@erols.com.  Note that all beta  releases  are  done  via
  98. e-mail so if your gateway can't handle some pretty big  mail  attachments,  you
  99. definitely do NOT want to be a beta tester for me!  Modifications that are  not
  100. of mainstream use can be contracted for.
  101.  
  102. WIN/NT AND WIN95 USERS:  All of these  programs  are  DOS  applications.   This
  103. means that they expect 8.3 filenames, short paths, etc.  If you use long  paths
  104. or illegal characters in your file names or whatever, these  programs  may  not
  105. work for you.  This is not a "bug" in the software.  That's just  the  way  DOS
  106. programs are.
  107.  
  108. STANDARD LEGAL DISCLAIMER:  Wayne Software disclaims all warranties as to  this
  109. software, whether express or implied, including without limitation any  implied
  110. warranties of merchantability, fitness for a particular purpose, functionality,
  111. data integrity or protection.
  112.  
  113.  
  114. BRUCE.DOC                              3                           Jul 31, 1997
  115.  
  116. -------------------------------------------------------------------------------
  117.            Finding the programs--Current version is 707 (1997 July)
  118.  
  119. The utilities are uploaded with a ZIP name that includes the year and month  of
  120. the release in a "ymm" format (mm-number month where 01=January, and  199y  for
  121. year).  The files are posted directly by  the  author  to  three  places.   The
  122. following Web site has the current versions of *all* programs:
  123.  
  124.                 http://www.geocities.com/SiliconValley/Lakes/2414
  125.  
  126. Major revisions are directly posted by the author to the following sites:
  127. * Simtel (Coast-To-Coast): ftp.coast.net (http://www.coast.net/Simtel)
  128. * Simtel (Keith Petersen): ftp.simtel.net (http://www.simtel.net/simtel.net)
  129. * ZDI Software Library:  Ziff-Davis is provided notice of updates although
  130. I'm not sure how long it takes them to update them on their Web site.
  131.  
  132.                          Simtel locations and versions
  133.  
  134. http://www.coast.net/SimTel/msdos/      ftp://ftp.simtel.net/simtelnet/msdos/
  135.   ..arcutil/                            ..arcutils/
  136. av703.zip       Archive View: Free ZIP etc directory viewer
  137.   ..batutil/                            ..batchutl/
  138. dates704.zip    Warns you in advance of birthdays etc
  139. fortn707.zip    Fine-tunes DOS FOR command w/options
  140.   ..dirutil/                            ..dirutl/
  141. cops704.zip     Copies files modified since given date
  142. dirco707.zip    Updates files based on source directory
  143. dirto702.zip    Directory lister and totaller
  144. filup707.zip    Copy updated files based on a control list
  145.   ..diskutil/                           ..diskutil/
  146. fill704.zip     Stuffs as many files as possible on disk
  147.   ..internet/                           ..html/
  148. htmst707.zip    Reprocesses HTML pages for humans to read
  149.   ..offline/                            ..mailnews/
  150. eumal707.zip    Eudora utility for nicknames, boxes
  151.   ..spredsht/                           ..spredsht/
  152. convr707.zip    Convert dBase, ASCII-delim, fixed, 1-2-3
  153.   ..textutil/                           ..txtutl/
  154. bfind707.zip    Boolean FIND command (BFIND BEGIN & END)
  155. chang707.zip    Change strings in text/binary files
  156. fixtx707.zip    Translate text file characters en masse
  157. pagin707.zip    Paginates text (indexes, sorts, tables)
  158. read707.zip     Free viewer, also make any text self-viewing
  159. txtab707.zip    Generates text tables
  160.  
  161. If you're using a version of the programs that's more than six months old, it's
  162. almost always the case that there's a  newer  version.   Please  check  for  an
  163. update.    If   you   can   receive   binary   attachments,   contact   me   at
  164. WayneSof@erols.com for free updates.   Alternatively,  send  $10  made  out  to
  165. "Wayne Software" to  the  Wayne  Software  address  above  and  I'll  send  you
  166. everything on diskette.  (If you need anything other than  3.5"  high  density,
  167. specify that too please.)
  168.  
  169.  
  170. BRUCE.DOC                              4                           Jul 31, 1997
  171.  
  172. The versions of each program posted on SimTel are documented below  along  with
  173. the directory information for this  site.   The  *current*  versions  of  *all*
  174. programs are posted on the GeoCities site.
  175.  
  176.  
  177. -------------------------------------------------------------------------------
  178.                            Short program descriptions
  179.  
  180. NOTE:  All programs support early termination by pressing Escape.
  181.  
  182. AV.EXE: Archive directory viewer.  Presents list of files in archive (ZIP, ARC,
  183.    etc) and lets you sort as desired.  Also allows resetting of the  file  date
  184.    based on the archive's contents.
  185.  
  186. BFIND.EXE: Allows Boolean-type FIND requests.  For example, find any line  with
  187.    one string AND another one, or any line with one string  OR  another.   Also
  188.    allows wildcarded input file names.
  189.  
  190. CHANGE.EXE: Processes change commands in files.  Files can be of any  size  and
  191.    type (binary or text) and  are  processed  quickly.   Up  to  thirty  change
  192.    commands can be processed in a single pass.  Also provides ability to remove
  193.    trailing spaces from text files.
  194.  
  195. CONVERT.EXE: Converts  between  data  formats:   FROM  dBase,   ASCII-delimited
  196.    (typically commas between fields and quotes around strings), and fixed field
  197.    TO Lotus WKS,  ASCII-delimited,  dBase,  and  fixed  field.   Also  provides
  198.    ability to add and drop fields, giving you the ability to crunch tables.
  199.  
  200. COPSINCE.EXE: Copies all files modified since a given date.  Primarily used for
  201.    making sure you have a back-up of files and also to copy updated programs to
  202.    another place.  Lets you define your own groupings of files if desired.
  203.  
  204. DATES.EXE: Program that warns you in advance when an  event  like  a  birthday,
  205.    anniversary, or holiday is coming up.  The  idea  is  to  give  you  advance
  206.    warning so you can send a card or get out of town in time.
  207.  
  208. DIRCOMP.EXE: Similar in some ways to DOS's REPLACE command but adds ability  to
  209.    delete extra files in the destination subdirectory, copy hidden  and  system
  210.    files, and prepare a report showing inconsistencies.  Is frequently used  by
  211.    network administrators to update workstation files.
  212.  
  213. DIRTOTAL.EXE: Prepares report showing files in subdirectory or  drive.   Allows
  214.    restricting search based on date, size, attributes, etc.  Works on networked
  215.    and CD-ROM drives.  Produces more formalized report than some utilities  do.
  216.    Also allows you to look for duplicate file names.
  217.  
  218. EUMAIL.EXE: Eudora mail summarizer.  Dumps your  Qualcomm  Eudora  mailbook  as
  219.    well as summarizing the contents of all of your Eudora boxes and folders.
  220.  
  221. FILL.EXE: Program designed to move files off to floppy  diskettes,  taking  the
  222.    biggest files first and skipping those that won't fit.  Also works fine  for
  223.    transfers to/from DOS-compatible  networks,  removable  drives,  etc.   Also
  224.    supports  splitting  large  files,  creating  a  status  report,  and  other
  225.    features.
  226.  
  227.  
  228. BRUCE.DOC                              5                           Jul 31, 1997
  229.  
  230. FILUPDAT.EXE: Program which compares a selected list of files in a source  path
  231.    against those in another path and  copies  those  that  have  been  updated.
  232.    Similar to DOS' REPLACE command but works from a stored list  of  files  and
  233.    can handle any number of directories.
  234.  
  235. FIXTEXT.EXE: Program which applies a user-definable character-translation table
  236.    to a text file.  Can allow you to convert graphics characters to their  text
  237.    equivalents, lowercase letters to uppercase letter, etc.  Can also  be  used
  238.    to translate DOS text files to Mac or Unix text files and vice  versa.   Can
  239.    also expand tabs, remove leading and trailing spaces, remove backspaces, and
  240.    remove blank lines.
  241.  
  242. FORTUNE.EXE: A tuner-upper for the DOS FOR command.   Generates  a  batch  file
  243.    which does all those wildcard things you wished FOR could do (like  "FORTUNE
  244.    IN (*.BAS) DO RENAME %A %2*.*" to remove parts of file names).  Lets you  do
  245.    all sorts of things including distinguishing  file  name  roots  from  their
  246.    extensions as well as incrementing file names by specified values.
  247.  
  248. HTMSTRIP.EXE: Processes and removes  embedded  HTML  commands  from  Web  pages
  249.    downloaded from the Web.   Reflows  paragraphs,  processes  tables,  etc  as
  250.    straight ASCII text.  Can  function  on  individually-saved  pages  or  else
  251.    process your entire disk cache.  Ideal tool  for  resending  via  e-mail  or
  252.    dozens of different uses.  Awarded a "Best"  rating  by  "PC  Computing"  in
  253.    their July 1996 issue. Includes MOZ.EXE which renames the files in your  Web
  254.    cache subdirectory so you can identify them more easily.
  255.  
  256. PAGINATE.EXE: Reformats text files with  embedded  formatting  codes.   Handles
  257.    things like titles, footers, indexes, alignment, justification,  multicolumn
  258.    listings,  etc.   Also  provides  support  for  embedding  tabular  data  in
  259.    ASCII-delimited or dBase formats which can be embedded and/or sorted in your
  260.    reports.
  261.  
  262. READ.EXE, READY.EXE,  READINIT.EXE,  and  READMAKE.EXE:   Text  file   browsing
  263.    utilities.  READ--Supports marking, copying text, reading Unix and Mac  text
  264.    files, etc.  Handles files of 16,000 lines or less (approx  800,000  bytes).
  265.    READY--truncates or wraps lines over 255 characters in  length  but  handles
  266.    files of an unlimited number of lines.  READMAKE--Takes an  ASCII-text  file
  267.    and makes it self-viewable (using a READ clone).
  268.  
  269. TXTABLE.EXE: Program to generate text tables.  Allows inputs to  be  HTML-based
  270.    as well as one-record per cell.
  271.  
  272. 
  273.